Inside Macintosh: QuickDraw GX Graphics /

Chapter 2 - Geometric Shapes / Geometric Shapes Reference

Functions / Getting and Setting Shape Geometries

GXGetPoint

You can use the GXGetPoint function to determine the geometry of an existing point shape.

gxPoint *GXGetPoint(gxShape source, gxPoint *data);

source

A reference to the point shape whose geometry you want to determine.

data

A pointer to a gxPoint structure. The function copies the source shape's geometry into this structure.

function result

A pointer to a copy of the source shape's geometry.

DESCRIPTION

The GXGetPoint function copies the geometry information from the source point shape into the gxPoint structure pointed to by the data parameter. As a convenience, this function also returns a pointer to the point geometry as the function result.

If the source shape is not a point shape, this function posts the error code illegal_type_for_shape.

You must pass a pointer to a gxPoint structure in the data parameter--if you pass nil for this parameter, the function posts the error code parameter_is_nil.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
shape_is_nil
illegal_type_for_shape	(debugging version)
parameter_is_nil	(debugging version)

SEE ALSO

For general information about point geometries, see "Point Shapes" on page 2-16.

For the definition of the gxPoint structure, see page 2-104.

To create a new point shape, use the GXNewPoint function, which is described on page 2-111.

To change the geometry of an existing point shape, use the GXSetPoint function, which is described in the next section.

To draw a point geometry without creating a point shape, use the GXDrawPoint function, which is described on page 2-158. To draw a point shape, use the GXDrawShape function, which is described in the chapter "Shape Objects" in Inside Macintosh: QuickDraw GX Objects.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help